Learning Paths
Five routes through this material, each ordered so that later pages build on earlier ones. Each path assumes no prior reading of the others.
1. New to digital health
For someone joining the field — a clinician moving into informatics, a developer new to health, a programme officer.
- Glossary — skim it; return to it constantly
- Architecture overview — the layers and the order in which decisions get made
- Interoperability — the four levels; the single most useful mental model in this field
- HL7 FHIR — the standard you will meet first
- Standards directory — what else exists and what each is for
- OpenHIE — how a national ecosystem is arranged
- Registries — why identity comes before exchange
- Health data — what health data is and why it is difficult
- Maturity model — locate wherever you are working
The idea to take away: most failures blamed on technology are identity, terminology or governance failures one layer down.
2. Developer
For someone who will write integration code.
- Interoperability — the four levels
- HL7 FHIR — resources, REST, references
- FHIR implementation guides — the key insight: nothing interoperates against "FHIR"
- FHIR servers and HAPI FHIR — get one running
- OAuth 2.0 and OpenID Connect
- SMART on FHIR — build a launch flow
- Terminology services — stop hard-coding code maps
- HL7 v2 — because it is what you will actually be integrating
- Integration engines and OpenHIM
- FHIR Bulk Data and Subscriptions
- Observability — and the rule about keeping patient data out of logs
- DevSecOps — synthetic test data, and why
Practical exercise: stand up HAPI FHIR, generate synthetic patients with Synthea, load them, write a SMART app that reads observations, then validate everything against an implementation guide.
3. Health architect
For someone responsible for the shape of an ecosystem.
- Architecture overview
- Enterprise architecture — the capability/system gap table is the highest-value hour in this path
- Architecture frameworks — and which ones are not health standards
- OpenHIE, then all four of its component pages
- Registries → client registry → facility registry
- Health information exchange
- Centralised vs federated HIE — the decision that shapes everything else
- Terminology services
- Identity, security and trust and consent and trust
- Data architecture
- Architecture patterns — the whole catalogue
- C4 model and ADRs — how to write it down
- Governance
- Maturity model — assess your ecosystem
- Checklists and templates
Practical exercise: run the maturity assessment with your team, requiring evidence for every score. The two lowest dimensions are your work programme.
4. Government and policy
For someone writing strategy, policy or tenders, who does not need to write code.
- Awesome Health Architecture overview — the architecture map
- WHO and global guidance — the documents that give your policy external legitimacy
- Interoperability — particularly the organisational level, which is where programmes stop
- Standards directory — enough to specify standards in a tender without naming products
- OpenHIE — the ecosystem shape
- Registries — the sequencing argument, and why the facility registry comes first
- Digital public infrastructure — including the identity coverage and linkage risk questions
- Consent and trust — consent models and trust frameworks
- Governance — especially the procurement requirements list
- Maturity model
- Country architectures
- Checklists
The two things to take into your next tender: require data extractability at exit with the cost stated in the contract, and require conformance to a named implementation guide demonstrated by test rather than asserted.
5. AI engineer in health
For someone building AI systems that touch health data.
- Health data — what you are permitted to use, and what de-identification does and does not achieve
- HL7 FHIR — the shape of the data
- Terminology services — why coded data is not consistent across facilities
- Data architecture — operational versus analytical
- FHIR Bulk Data — how to get data out, and the governance that must accompany it
- Machine learning — evaluation and deployment realities
- AI architecture — where models attach, and the components beyond the model server
- Clinical AI — regulation; read before building, not after
- SMART on FHIR and CDS Hooks — the standards-based integration paths
- MCP in healthcare — and why it is not a health standard
- AI ethics and consent and trust
- Governance — the AI governance section
The mistake to avoid: building on data that cannot be pooled. If terminology and identity are not sorted out, a model trained across facilities is learning the facility, not the patient. Check the maturity model before starting.
External learning resources
| Resource | For |
|---|---|
| HL7 FHIR specification — https://hl7.org/fhir/ | The primary source; the "Getting Started" pages are genuinely good |
| SMART Health IT tutorials — https://smarthealthit.org/ | Building SMART apps |
| HAPI FHIR documentation — https://hapifhir.io/ | Java FHIR implementation |
| DHIS2 Academy — https://academy.dhis2.org/ | DHIS2 implementation and use |
| OpenHIE community — https://ohie.org/ | Architecture and community calls |
| WHO Academy and WHO publications — https://www.who.int/publications | Policy and guideline material |
| HL7 connectathons — https://www.hl7.org/events/ | The fastest way to learn FHIR properly |
| Synthea — https://synthetichealth.github.io/synthea/ | Synthetic data to practise on |
Connectathons deserve emphasis. Two days of implementing against other people's servers teaches more about interoperability than any amount of reading, including this.